home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir39 / 2000tech.zip / 1004.TXT < prev    next >
Text File  |  1993-06-15  |  9KB  |  215 lines
  1. Document Number 1004
  2. Logitech Mouse Driver and VESA Super VGA Support
  3. 1/27/93
  4.  
  5.  
  6. Background :
  7. ------------
  8. The VGA Standard which was established by IBM, defines a video architecture 
  9. and video modes.  Many video manufacturers follow this standard and add 
  10. enhancements to it.  As manufacturers refine their video boards, a new set 
  11. of 'above VGA' video resolutions and architecture's have been created. To 
  12. bring these many different video schemes together VESA (Video Electronics 
  13. Standard Association) was formed to give direction to the future of video 
  14. standards for the IBM personal computer.
  15.  
  16. Super VGA is loosely defined as anything above the VGA standard.  This 
  17. includes higher resolutions (e.g. 800 x 600 for VESA mode 100h) and greater 
  18. or equal number of colors (e.g. 256 colors for VESA mode 103h).
  19.  
  20. DOS Mouse Driver:
  21. -----------------
  22. Under DOS, many applications require that the mouse driver draw the mouse 
  23. cursor.  To do this the mouse driver must have knowledge of the underlying 
  24. video architecture and the video mode that is being displayed.  This presents 
  25. problems as video boards surpass the VGA limit.  As video boards become more 
  26. complex the mouse driver must be expanded to handle all situations.
  27. To remedy this both VESA and Logitech have established the Video Cursor 
  28. Interface (VCI) Standard.  This standard outlines the interface between 
  29. an input device, such as a mouse, and a small overlay program that 
  30. contains hardware dependent cursor drawing code.  The interface contains 
  31. initialization, cursor movement and cursor function calls.  The host (or 
  32. mouse in this case) calls the VCI module to perform all cursor functions.  
  33. The host need not have any knowledge of the cursor drawing software/hardware.
  34. The VCI module program can be implemented in one of three forms: 
  35.  
  36. A] overlay program that the host program loads 
  37. B] TSR/device driver program that redirects INT 10h to itself  
  38. C] as a ROM resident code
  39.  
  40. For Logitech Mouse Software the overlay program (LVESA.OVL) is the only 
  41. method used.
  42.  
  43. Other Operating Environments/Systems:
  44. -------------------------------------
  45. Under other operating environments (Windows, GEM) and operating systems 
  46. (OS/2, UNIX) the mouse driver is not required to display the cursor on the 
  47. video screen.  The mouse driver simply acquires button and movement 
  48. information and passes this information to the operating environment/system 
  49. which does the rest of the work.  The VCI does not apply to such operating 
  50. systems/environments.
  51.  
  52. Logitech VCI Compatible Mouse Driver:
  53. -------------------------------------
  54. As outlined above the LVESA.OVL module allows for a separation of the cursor 
  55. drawing code from the input device code.  Additional video modes or hardware 
  56. configurations can be added to the overlay without rewriting a complete mouse 
  57. driver.  Any driver that supports the VCI interface will support the overlay 
  58. module.
  59.  
  60. Starting from the 6.10 release, the Logitech DOS driver is made up of the
  61. three following files:
  62.  
  63.    1) MOUSE.COM           : mouse driver
  64.    2) LMOUSE.INI          : mouse driver configuration file
  65.    3) LVESA.OVL           : video module for the DOS driver
  66.  
  67. MOUSE.COM:
  68. ----------
  69. During initialization MOUSE.COM searches for the LMOUSE.INI initialization 
  70. file.  This text file contains information used for mouse driver 
  71. initialization such as the drive and path of a LVESA.OVL overlay program.  
  72. The mouse driver searches for a LVESA.OVL overlay module, if specified, 
  73. and loads it into memory.  The driver calls the LVESA.OVL initialization 
  74. routine.  If initialization is successful the overlay code is copied into 
  75. the mouse driver.  If initialization fails the mouse driver uses it's default 
  76. video cursor code.
  77.  
  78. The Logitech DOS mouse driver contains cursor enhancements which enhance 
  79. cursor viewing in DOS programs that use the mouse driver's cursor.  
  80. Cursor enhancements are not available when the LVESA.OVL is being 
  81. used.
  82.  
  83. LMOUSE.INI:
  84. -----------
  85. This text file contains initialization information that is used on the 
  86. initial loading of the mouse driver.  The initialization file contains 
  87. information such as the operating mode of the mouse (for left handed 
  88. users) and the drive and path of the LVESA.OVL file.  If no drive or 
  89. path are used, the mouse driver launching drive:directory is assumed.  If 
  90. LMOUSE.INI is not present the mouse driver assumes a right handed mouse 
  91. and uses it's internal video cursor drawing code.  LMOUSE.INI is created 
  92. by the mouse installation program at installation time.
  93.  
  94. The search order for the LMOUSE.INI is as follows:
  95. --------------------------------------------------
  96. 1) A SET statement in the AUTOEXEC.BAT file contains the drive and path 
  97. to the mouse directory (implemented but not currently used by Logitech).
  98.     e.g. SET MOUSE=C:\TEST\MOUSE;
  99. 2) Search the same directory as the mouse driver (DOS Version 3.0 and 
  100. above).
  101. 3) Search the root of the C: disk drive (DOS 2.X and lower).
  102. 4) Search the root of the A: disk drive for floppy drive systems.
  103.  
  104. LMOUSE.INI is used by the DOS mouse driver only.  Later expansions may 
  105. include usage by other mouse drivers (Windows mouse driver). 
  106.  
  107. Currently LMOUSE.INI contain 2 main sections, MOUSE and DISPLAY.  The 
  108. MOUSE section tells the mouse driver if a left handed mouse is attached 
  109. to the driver.  This is used for Logitech software only, it does not 
  110. swap the mouse buttons.
  111.  
  112. [MOUSE]
  113. mode = right (or left)
  114.  
  115. The DISPLAY section gives the drive, path and name of the video overlay 
  116. (drive and path are optional if the overlay is located in the same 
  117. directory as the mouse driver).  If the user wishes to change video 
  118. overlays they must edit this entry to a new drive, path and overlay 
  119. name.  This entry may also contain the reserved word RESIDENT.  RESIDENT 
  120. is used for a TSR or ROM version of the VCI module.
  121.  
  122. [DISPLAY]
  123. VideoModule = DRIVE:\PATH\OVERLAY_NAME.OVL      ;use a separate .OVL 
  124. program
  125.   or
  126. VideoModule = RESIDENT          ;use the resident VCI module
  127.   or
  128. VideoModule =                   ;nothing, use the drivers default cursor
  129.  
  130. LVESA.OVL:
  131. ----------
  132. The Logitech VCI overlay program that contains video cursor support for 
  133. CGA, EGA, VGA and VESA Super VGA video modes.  This program is copied 
  134. into the mouse driver at initialization and becomes part of the resident 
  135. mouse driver.
  136.  
  137. MOUSE.SYS:
  138. ----------
  139. Because of DOS system constraints the device driver version of the mouse 
  140. driver (MOUSE.SYS) does not have the ability to read the LMOUSE.INI file 
  141. or load the LVESA.OVL file.  This may change in future releases.
  142.  
  143. DOS Driver Cursor Enhancements:
  144. -------------------------------
  145. As mentioned above the Logitech DOS mouse driver cursor enhancements are 
  146. not available with the LVESA.OVL.  Using the cursor enhancements will 
  147. disable loading the LVESA overlay.
  148. To load the cursor enhancements, use the following command line 
  149. parameters on the first call to the mouse driver:
  150.     CENHANCE
  151.     COFF, CSLOW, CFAST
  152.     LCURSOR, DCURSOR
  153.     TOFF, TON
  154.  
  155.     Example:  MOUSE CENHANCE
  156.  
  157. If the cursor enhancements are not loaded these parameters will not work 
  158. on following calls to the mouse driver.
  159.  
  160. Loading Other VCI Overlays Modules:
  161. -----------------------------------
  162. The VCI standard is very new and currently not used by any other mouse 
  163. makers or video manufactures.  Other video manufactures may adopt it and 
  164. their end users will need to install these new overlay files.  To change 
  165. the overlay file being used the LMOUSE.INI file will need to be edited 
  166. as follows:
  167.  
  168.     [DISPLAY]
  169.     VideoModule = DRIVE:PATH\NEW_OVL.OVL
  170.  
  171. where NEW_OVL is the name of the new users overlay program.  The 
  172. DRIVE:PATH are needed if the overlay is not located in the mouse drivers 
  173. directory.
  174.  
  175. ROM Resident Overlay or TSR's:
  176. ------------------------------
  177. Some video manufactures may  put their video overlay code in ROM BIOS or 
  178. in a TSR (Terminate and Stay Resident) program.  The video manufacturer 
  179. should provide information to the user about this.  To enable the mouse 
  180. driver to search for a BIOS VCI implementation or TSR the LMOUSE.INI 
  181. should be edited as follows:
  182.   
  183.     [DISPLAY]
  184.     VideoModule = RESIDENT
  185.  
  186. This line tells the mouse driver to search for the video overlay that is 
  187. already present in memory.
  188.  
  189. Disabling LVESA.OVL Loading:
  190. ----------------------------
  191. Two methods are used to disable the usage of the LVESA.OVL overlay:
  192. 1) Alter the 'VideoModule' string in the LMOUSE.INI file.  This is done 
  193. by:
  194. a) removing the overlay file name from the string:
  195.  
  196.         VideoModule = LVESA.OVL         ;current setting
  197.  
  198. change to
  199.  
  200.         VideoModule =                   ;nothing
  201.  
  202. b) commenting out the entire VideoModule line:
  203.  
  204. ; VideoModule = LVESA.OVL
  205.  
  206. Note:  This will cause an error to be displayed during the mouse driver 
  207. initialization.  This error will have no effect on the mouse drivers 
  208. loading.
  209.  
  210. 2) Use the 'NOVCI' parameter on the first call to the DOS mouse driver:
  211.  
  212.     MOUSE NOVCI
  213.  
  214. This forces the mouse driver to use it's internal video code.
  215.